<jboss-install>/bin/standalone.sh -c=standalone-teiid.xml
Teiid needs to be installed into an existing JBoss AS 7.1.1 installation.
Teiid does not support the "embedded" mode in 8.1 version. ("embedded" will be coming in a future release).
Download the JBoss AS application server. Install the server by unzipping into a known location. Ex: /apps/jboss-7.1.1
You may also choose to use an existing AS installation. However if a previous version of Teiid was already installed, you must remove the old Teiid distribution artifacts before installing the new version.
Download Teiid. Unzip the downloaded artifact inside the JBoss AS installation. Teiid 8.1 directory structure matches JBoss AS directly - it is just an overlay. This will add necessary modules and configuration files to install Teiid in JBoss AS 7.1.1 in both Standalone and Domain modes. Teiid provides separate configuration files (standalone-teiid.xml and domain-teiid.xml) for both modes apart from the default configuration files come with JBoss AS 7.1.1, so that it does not overwrite any previously modified configuration. Also, this gives facility to remove the unused services from this configuration that are not used by Teiid and not required by user for their applications.
The "Domain" mode recommended in a clustered environment to take advantage of clustered caching and cluster safe distribution of events. Only Teiid's default configuration for Domain mode configured for high availability and clustered caching.
if you want to start the "standalone" profile, execute the following command
<jboss-install>/bin/standalone.sh -c=standalone-teiid.xml
To start the server in "Domain" mode, install the JBoss AS 7.1.1 and Teiid 8.1 on all the servers in are going to be part of the cluster. Select one of the server as the "master" domain controller, the rest of the servers will be slaves that connect to the "master" domain controller for all the administrative operations. Please refer to JBoss AS provided documentation for full details.
Once you configured all the servers, start the "master" node with following command
<jboss-install>/bin/domain.sh
and on "slave" nodes
<jboss-install>/bin/domain.sh
The slave nodes fetch their domain configuration from the "master" node.
Once all the servers are up, to complete the installation for the domain mode, run the following command against "master" node. Note that this only needs to be run for once per whole domain install. This script installs Teiid in HA profile. This also re-configures main-server-group to start the HA profile. Since in domain mode you can not statically deploy resources by dropping them in the domain/deployments folder, this script deploys default resources required (file, ldap, salesforce and ws connectors) using the CLI interface.
<jboss-install>/bin/jboss-cli.sh --file=scripts/teiid-domain-mode-install.cli
If the Teiid needs to be installed in other profiles other than HA profile, edit the teiid-domain-mode-install.cli file, and make edits appropriately for profile, socket-bindings, server-groups and then run the above command.
That it!. JBoss AS and Teiid are now installed and running. See below instructions to customize various other settings.
Once VDBs have been deployed, users can now connect their JDBC applications to Teiid. If you need help on connecting your application to the Teiid using JDBC check out the Client Developer's Guide.
This shows the contents of the Teiid 8.1 deployment. The directory structure is exactly the same under any JBoss profile.
/bin
/scripts
/docs
/teiid
/datsources
/schema
/examples
/domain
/configuration
domain-teiid.xml
teiid-security-users.properties
teiid-security-roles.properties
/modules
/org/jboss/teiid/*
/standalone
/configuration
standalone-teiid.xml
teiid-security-users.properties
teiid-security-roles.properties
/deployments
teiid-*.rar
Has installation and utility CLI scripts.
Has documents, examples, sample data source XML fragments and schema files. Contains artifacts need by the Quick Start Example.
standalone-teiid.xml - Master configuration file for Teiid system. This file contains Teiid subsystem in addition to standard JBoss AS web profile subsystems
teiid-security-users.properties,teiid-security-roles.properties - These files define the allowed users and their defined roles in Teiid using the default security domain. Edit these files to add users. If you want to use a different security domain change the security domain details in main configuration file.
This directory contains all the resource-adapter RAR files that are supplied as part of the Teiid installation. Note that resource adaptors are not installed by default for the domain mode.
This directory defines the modules for JBoss AS 7.1.1 system
domain-teiid.xml - Master configuration file for Domain mode. This file contains Teiid subsystem in addition to standard JBoss AS web profile subsystems.
teiid-security-users.properties, teiid-security-roles.properties - These files define the allowed users and their defined roles in Teiid using the default security domain. Edit these files to add users. If you want to use a different security domain change the security domain details in main configuration file.
This directory contains Teiid client libraries. It has the Teiid JDBC driver jar, "teiid-8.1.0.Final-jdbc.jar", and also contains "teiid-hibernate-dialect-8.1.0.Final.jar" that contains Teiid's Hibernate dialect.
This directory contains temporary files created by Teiid. These are mostly created by the buffer manager. These files are not needed across a VM restart. Creation of Teiid lob values (for example through SQL/XML) will typically create one file per lob once it exceeds the allowable in memory size of 8KB. In heavy usage scenarios, consider pointing the buffer directory at a partition that is routinely defragmented.
This directory contains cached vdb metadata files. Do not edit them manually.